Copilot summary:

This pull request introduces structured error handling to the Dataverse SDK by adding custom error classes and subcodes, replacing generic exceptions with more descriptive, domain-specific errors. It also enhances HTTP error reporting with more details and improves validation and metadata error handling. Comprehensive tests are added to ensure proper error propagation and coverage.

Error Handling Enhancements

• Added new error subcodes in error_codes.py for validation, SQL parsing, and metadata operations, enabling more granular error reporting.
• Introduced custom error classes—ValidationError, MetadataError, and SQLParseError—in errors.py, extending DataverseError for structured exception handling.
• Updated DataverseError and HttpError constructors to standardize error attributes, set default sources, and enrich HTTP error details (e.g., correlation IDs, retry-after, body excerpt). [1] [2]

SDK Codebase Changes

• Replaced RuntimeError and ValueError with the new custom error classes throughout odata.py, providing more meaningful error messages and subcodes for validation and metadata errors. [1] [2] [3] [4] [5]
• Improved HTTP error handling in _request to extract error details from responses and map status codes to subcodes, with better transient error detection and retry-after support.

Testing Improvements

• Added tests/test_http_errors.py to verify HTTP error handling, subcode mapping, transient detection, and error detail extraction.
• Updated tests/test_logical_crud.py to expect MetadataError instead of RuntimeError for unknown logical names, reflecting the new error handling approach. [1] [2]